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COPYRIGHT 1981 Atari ^ Inc* 



Copyright and right to make backup copies * On receipt of this computer program and associated 
doojfTieiitatiofi (the sof tware)* ATARI grants to you a nonexdumiye license to execute the enclosed 
software and to make backup or archival copies of the computer program for your personal use only 
and only on the condition that all copies are conspicuously marked with the same copyright notices 
as appear on the originals This software is copyrighted* You are prohibited from reprpdudingf 
translatingf <^ diiitributing thin softw^e in any unauthcirizecl man 
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introdxjction: 



OVERVIEW 

* XREF is a utility program that gives you important information about your BASIC programs* It 
tells you the number of variables you've used* which is helpful in large programs* where you 
might be ^proaching the i28"-vauriable Umitt It also Usts the names of ^ these variables 
and ttve lines in which you We used them* This informatim can be valuable for debugging 
complex BASIC programs* because it helps you to see where your variables are located and how 
they interact* Finaily# it lists your constants and tells you how often you used each one* 

Tfm program is simple to use* You answer one prompt and XREF does all the work! Tcmj tan tf^ 

obtair^a video display version or a printed version of the resulting information* 

40K RAM 

ATARI BASIC Language Cartryige 

ATAia 810 Disk DWve - 



OPTIONAL ACCESSORIES 



ATARI printer or equivalent printer 
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!♦ Insert the ATARI BASIC Language Cartridge in the (Left Cartridge) slot of your computer* 

2* If you want printed outputt turn on your printer* If you're using an ATARI 325 Printer, 

turn on your ATARI 850 Interface Module* 

3* Turn on your disk drive(s) and insert the XREF (diskette in disk drive one* 
4f Power up your computer and turn on your video streen* 

5* When the READY prompt displays, type one of the following commands: (1) to run the version 
that prints your output, type RUN "D1XREF*PRT" and press the RETURN key, or (2) to run the ^ 
version that displays your output at your video screen, type RUN "DtXREF" and press the RETURN 

Note* XREF requires that you store your file in SAVE format rather than in LIST format* If 
you've stored your file in LIST format, load it into RAM and then store it back to disk via 
the SAVE DSfilename command* 




RUNKIMG THE PROGRAM 



After the COPYRIGHT 1981 ATARI notice appears* XREF prompts you for the file name of your 
BASIC program} 

INPUT FILE name: 

If you're using cm# disk drivet remove the XREF diskette and insert the diskette with the 
program y%u want Gross«*risfermcedf and then type in th» dir^ice initial and the file i^ame as it 

appears on the DOS directory (e*g»t D:CHECKER)» If you're using more than one disk drive^ 
remernber to specify the number of the drive containing your file (e»g«> D2#CHECKER)» 

XREF then takes over* If you're using the program that prints your outputf XREF will 

automatically print the results* If you're using the program that displays your output at the 
video screent you'll need to stand by until XREF starts listing the results* Then use the 
CTRL/ 1 function to stop the display temporarily so that you can write it downl press CTRL/1 to 
riHMM the listing* 




OUTPUT 

Reading your source program 

The first output will be to your video screen and will consist of what look like random 
characters* These are th# Screen Editor's interpr#ation of code stored by the system in 
internal symbol tables* Next> XREF lists how many variables you used and the message 
TABLE SAVE IN PROGRESS indicates it is setting up the variable table* Then XREF slowly 
writes the source program on the screen* However, XREF changes the variables and 
constants as it sets them up for its own use* XREF alsci pauses how anci then fcnr a disk 
read* XREF obeys all control and escape commands it encounters, so don't worry if the 
cursor jumps around on the screen or if you hear a beep now and again* Once XREF has read 
the complete source file> it displays tte (fiessage EQF FOUND* And when it has finished 
working with your sotrce programt it ilisplays the ^li^age EMD OF U^* 

Generating the results 

Once XREF completes its analysis of your source program* it displays (or prints) the 

results* Figure 1 illustrates a sample output — video display or printed* 

First it displays the CROSS-REFERENCE message, followed by the total number of variables 
used (1) and the variable table (2)* Each variable name displays in the #ar left column $ 

a left parenthesis after the name indicates a one- or two-dimensional array and a dollar 
sign after the name indicates a string} the line numbers jn your sauce progr#m using the 
vari^le display following this information* 

Notice that one variable, RAM, has no line numbers following it (3)* Any variable you 
deleted from your program, but is still present in BASIC'S internal symbol table displays 
in this form* To remove such variables from the internal symbol table, LIST your source 
program to disk and £HT^ it back into RAM CtMs erases the current internal symbol 
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table)* Then SAVE your source program back on disk again (BASIC will then generate a new 
internal symbol table for your program)* For more information about this procedure* read 
the sections on LOAD, SAVE, LIST, and ENTER in the ATARI Disk Qperatina System 
Reference ManuaL The BASIC Reference Manual , pp* 2-3, also contains information 
about using the LIST format* 

The XREF variable table is formatted as described above either on the display screen or 
on the printer, depending on which XREF program you're using* If you're using the video 
display version (file name XREF), the screen will be formatted as described* If you're 
using the printed version (file nam XREF*PRT), the screen display will be somewhat 
jumbled, but the printed table will be formatted at described* 

Next, XREF generates the constant chart, which consists of two columns of numbers (4). 
The left column lists the number of times each constant is used} the right column lists 
the constant* 

CROSS REFERENCE 

(1) 4 VARIABLES USED 

(2) RAM< 



<3) RAM 



10 


30 


6 0 


70 


80 


90 


140 


140 


140 


140 






20 


30 


30 


40 


50 


60 


60 


70 


80 


80 


90 


90 


100 


130 


140 


140 


140 


140 


140 


150 


60 


60 


70 


70 


80 


80 


90 


90 



(4) NO* 

TIMES 



USED CONSTANTS 

3 1 

2 2 

2 3 

2 4 

3 5 
3 6 
8 8 

1 48 



Figure 1» Sanple Output 



ERROR CODES 



You might encounter some error codes during start-up procedures* ERROR 170- (File Not Found) 
will display if you enter a file name in response to the INPUT FILE NAME J prompt that doesn't 
correspond to a file name in your DOS directory* Make #ure you specif icHi the correct disk 
drive and that you spelled the #le name correctly 1^1^ ttirt over by typing RUN and 
answeicing file name the prompt* 

ERROR 130- (Nonexistent Device specif ied« Device is not turned on or not attached*) wiU 
display if you forget to enter DJ preceding your file nafiHi* Type RUM and renter your file 

name in response to the file name prompt* 

ERROR 138- (Device Timeout* Device doesn't respond* Check connections between peripheral 
equipment and console*) will display is you're using the printer versicHrt of XREF but neglect 

to turn on your printer (and interface)* Type RUN and start over* If you don't have a printer 
connected and you get this error code# then you're usijig the wrong program* Use the RUK 
"DtXREE" pE^i^^ 



PROGRAM OPERATION WARIONGS AND UMITATIONS 

XREF takes a substantial amount of time to run^ and you'll be frustrated if you've waited 
^ through a long program only to lose the result should someone accidentally press the BREAK key 
P after the program has run or should you be called away from the computer* Or^ then again^ you 
might want to see the results another time* To reproduce the viu^iable cross-referinGe and 
constant tables^ type GOTO 3050t which will call the subroutine generating these tables* 
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REVIEW FOfM 



We're interested in your experiences with APX programs and documentation t both favorable and 
unfavorable* Many software authors are willing and eager to improve their programs if they know 
what users want« Andt of course^ we want to know about any bufls that slipped by us» so that the 
wftiMW#uthor can fix ttiwif W« also %»ant to kno%# whetMr €%jr documentation is meeting your needs 
Too are our best source for suggesting improvements! Please help by taking a moment to fill in this 
review sheet* Fold the sheet in thirds and seal it so that the address on the bottom of the back 
becomes the envelope frontt 

It Name and APX number of program - . ' • - . - . ' / ' : ■ ' . ' 

2» If yoy hatv» pre*l«TO using the progriymi^pl#«iMM||i#P^ htret 



3« What do you especially Uiui about this prograiii? 



4* What do you think the program's wmdoiesses are? 



5* How can the catalog description be more accurate and/or comprehenMve? 



6* On a scale of 1 to 10* i being "poor" and 10 being "eacceUent'Vf pleasfiTate J^t^ follpv^ioa 
aspects of this prograittt 

^ Easy to use 

User-oriented (et9»f .mpnus» promptSf clear language) 

Enjoyable 
Self-instructive 

Useful (for non-game software) 

ImaoiDative graohics and sound 



?• Dttscribe any technical wtors you found in the user instructions (please give page numbers) 



8* What did you especially like about the user instructions? 



9» What revisions or additions would improve these instructions? 



10* On a scale of 1 to 10» 1 representing "poor" and 10 representing "excellent"* how would you 
rate the documentation and why? 



11* Other comments about the software or the user instructions! 
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